home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / cli / mx2.arc / MX2.TXT < prev    next >
Text File  |  1988-06-11  |  29KB  |  1,585 lines
  1.  
  2. - 1 -                          MX2 Multitasking Kernel
  3.  
  4.  
  5.  
  6.  
  7. **************************************************************************
  8. *       Due to my now being a multimillionaire I am forever giving away  *
  9. *       the complete source and the complete program is now              *
  10. *                  !!!       PUBLIC DOMAIN     !!!                       *
  11. *                                                                        *
  12. *                  !!!            FREE         !!!                       *
  13. *       As a service to help down and out C programmers around the       *
  14. *       world you can still send a donation to                           *
  15. *                                                                        *
  16. *               Fred Brooks                                              *
  17. *               4145 44ST #5                                             *
  18. *               San Diego CA 92105                                       *
  19. *                                                                        *
  20. *               You will receive a thank you and can continue            *
  21. *               to live with a clear conscience.                         *
  22. *                                                                        *
  23. *               MX2 V2.3.0    A multitasking and multiuser               *     
  24. *               environment for ATARI ST.                                *
  25. *               Written using TDI Modula-2 3.01a Compiler                *
  26. *               For TOS Versions 11/20 1985 and 04/22 1987               *
  27. *               Other Versions may not run correctly.                    *
  28. *                                                                        *
  29. *               This set of programs are NOT for sale by anyone and I    *
  30. *               reserve all rights to it's ownership.                    *
  31. **************************************************************************
  32.  
  33.  
  34.  Intro: MX2 is a multitasking environment to aid in program development
  35.         for the ATARI ST. It was developed in Modula-2 but can be used
  36.         with any language such as C, BASIC, or PASCAL. Suggested system
  37.         minimum requirements are 1 MEG of memory with a double-sided
  38.         disk drive. A hard disk drive will greatly improve system
  39.         performance.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                MX2 Multitasking Kernel
  66.  
  67.  
  68. - 2 -                          MX2 Multitasking Kernel
  69.  
  70.  
  71.  NOTES:
  72.  
  73.         I have tuned this kernel for use with the GULAM shell. I have 
  74.         had no problems using it exempt with the TE communications command.
  75.         It locks up my background xmodem routines if used.                           
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                MX2 Multitasking Kernel
  132.  
  133.  
  134. - 3 -                          MX2 Multitasking Kernel
  135.  
  136.  
  137. SYSTEM GENERATION:
  138.  
  139.         The MX2.INF file contains the system generation parameters.
  140.         It is an ASCII files that can be edited with the UE editor in
  141.         GULAM or any ASCII editor This files allows you to change the
  142.         default system boot parameters
  143.         If this file does not exist the default values are:
  144.                 numeric values are in decimal
  145.  
  146.         Init Command              : IP CLI.PRG
  147.         System Memory             : 32000
  148.         Alt Program HOTKEY        : 3276800
  149.         Normal Mouse HOTKEY       : 3211264
  150.         Cursor Mouse HOTKEY       : 3014656
  151.         Reboot HOTKEY             : 1245184
  152.         Reserved Memory           : 32000
  153.  
  154.         The initialisation command is normally used to load the SHELL
  155.         program. The CLI.PRG enables GULAM.PRG to multitask then loads
  156.         the program. If the program is exited the kernel will respawn
  157.         the SHELL. To load a program other than the SHELL edit the line to
  158.         to IP "name of program".
  159.  
  160.         System memory is the size of the memory reserved by MX2 to
  161.         allocate for it's internal data structures. The default size
  162.         should be adequate for 7 MX2 processes with a workspace of 2K
  163.         each.
  164.  
  165.         Reserved memory is the size of the memory block that will be split
  166.         off of the main memory heap.  This memory should still be available
  167.         with GEM programs that allocate all available memory with a malloc(-1).
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                MX2 Multitasking Kernel
  198.  
  199.  
  200. - 4 -                          MX2 Multitasking Kernel
  201.  
  202.  
  203. MX2.ACC:
  204.  
  205. The MX2.ACC will not work correctly if you try to run two or more GULAM
  206. shells. Because both would be GEM programs and the AES would hang or get lost
  207. . If you want to have a remote or wish to run two shells from the desk to
  208. please select the OFF option from the desk ACC before starting up the second
  209. shell with the go.g script file or by typing the commands. I am trying to
  210. work around this problem.
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                MX2 Multitasking Kernel
  264.  
  265.  
  266. - 5 -                          MX2 Multitasking Kernel
  267.  
  268.  
  269. LOGIN and PASSWD file:
  270.  
  271. The MX2 password system uses five fields separated by a colon.
  272.  
  273. The file 'passwd' contains all password records.
  274.  
  275. field 1         userid
  276. field 2         password
  277. field 3         path
  278. field 4         program
  279. field 5         comment
  280.  
  281. Example         mx2::::
  282.  
  283. Is the minimum password record. It contains only the userid field with the
  284. other fields set to null. This would login user 'mx2' with no password to
  285. the default path 'current path' and run the default program 'gulam.prg'.
  286.  
  287. Example         fred:AXKHRWQ:c\mx2:gulam.prg: login as me using my work id
  288.  
  289. Would login user 'fred' using encrypted password 'AXKHRWQ' to drive 'c' 
  290. path '/mx2' "note if a drive is specified DO NOT use a colon between the drive
  291. character and the path" and run program 'gulam.prg'. The comment is not used 
  292. by the program and is there to inform the user. The program field could have 
  293. been a null entry or any other valid program. The program field 
  294. may include subdirectories. ie ':\mx2\gulam.prg:'
  295.  
  296. The 'passwd.prg' is used to set and change user passwords. New users must
  297. have a null field 2 when it is created. Passwords MUST be set with the
  298. passwd.prg.
  299.  
  300. USAGE:   passwd fred
  301.                 ^
  302.                 user
  303.  
  304. Where fred is a system username in field 1 of a password record.
  305. If there is no password the program will ask for a new password.
  306. If a password already exists you will be asked for the old password
  307. first, then if it is correct you can change the password. Passwords must be
  308. at least 4 characters long.
  309.  
  310. Examine the supplied passwd file for more examples.
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                MX2 Multitasking Kernel
  330.  
  331.  
  332. - 6 -                          MX2 Multitasking Kernel
  333.  
  334.  
  335. INTERFACE LIBRARIES:
  336.  
  337.         The SYSCALL module is the standard interface for user programs
  338.         to the MX2 Multitasking system. It includes functions to starting
  339.         ending and controlling concurrent processes. The TDILIB contains
  340.         the TDI MODULA-2 3.01a libraries. I will include a portable C
  341.         library as soon as I can translate the code over.
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                MX2 Multitasking Kernel
  396.  
  397.  
  398. - 7 -                          MX2 Multitasking Kernel
  399.  
  400.  
  401. COMMUNICATIONS:
  402.  
  403.         Also included is a no frills communications program.  
  404.         COM.TOS without options sets the AUX port to 1200BPS. 
  405.         COM.TOS # "where # is a number" will set the AUX port to 
  406.         the speed according to the table.
  407.                0      =    300BPS
  408.                1      =    1200BPS
  409.                2      =    2400BPS
  410.                4      =    4800BPS
  411.                9      =    9600BPS
  412.                H      =    19200BPS
  413.         Use the [Undo] key to exit ba